home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
sfrom120.zip
/
SFROM120.DOC
< prev
Wrap
Text File
|
1993-03-07
|
45KB
|
928 lines
SF-ROM DOOR
Version 1.20
Released March 7, 1993
Copyright (C) 1992-1993 by Mike Robinson
The Soft Parade
Shelton, Connecticut, USA
203-924-5603
------- OVERVIEW ------------------------------------------------------------
SF-Rom Door is a file access and download door designed for use on
Spitfire 3.x BBS. Files may be located on CD-ROM disks, magnetic
disks, or both. It provides browsing, text search and download
capabilities from within the door. It can even track the number of
files/bytes downloaded, enforce daily limits, and then record this
information in the main Spitfire database. A Spitfire SFFILES.BBS
type of file list is required for each file area. The door can be
run from the door menu or any of the menu extensions. This version
adds support for multiple CD-ROM disks.
SF-Rom can also serve as a very configurable menu extension. From
the same main menu a caller can choose from a selection of CD-ROM
disks, magnetic disk file areas, and external doors. These may be
used in any combination. When an external door is chosen, SF-Rom
exits with an ErrorLevel which is then used in a batch file to pass
control to the selected external door.
Right from the beginning this door was designed and optimized for
speed. And it is FAST. A file search of a 500 megabyte CD-ROM disk
takes only a few seconds.
Speed is especially important to those who run multiple nodes
and/or multiple CD-ROM drives such as the Pioneer DRM-600
"six pack." Considerable time and energy was spent working around
the speed limitations of today's CD-ROM drives.
Actual CD-ROM drive hardware access time has been minimized by:
1. Maintaining the file lists on the magnetic drive. This is
optional. If the CD-ROM itself contains file lists, these can be
be accessed directly by the door in order to save hard drive
space.
2. Copying the file to a holding directory on the hard drive and
downloading it from there. This is also optional. You can
configure the door to download directly from the CD-ROM drive.
3. Careful design of the the door logic. The CD-ROM drive hardware
is accessed as rapidly as possible and only when absolutely
required.
------- FEATURES ------------------------------------------------------------
■ Multiple disk support for up to 100 disks. Up to 1000 separate
file areas per disk. No external menu program required. In fact,
SF-Rom can now also be used as a menu extension. It will display
menus and terminate with an ErrorLevel. You can combine CD-ROMs
and other doors on the same menu. Disks can be put on/off line by
setting one value in the configuration file. Offline disks look
the same as online except no downloads. MegaSearch feature can
search ALL disks for matching text. Separate custom access
control for each disk can be set greater than, less than, or
equal to caller security level. This sets which levels can get
into each disk. In addition, any number of specific security
levels can be set for each disk to allow browse-only access with
no downloads.
■ Batch downloads and file tagging of up to 20 files.
■ Local browse and copy to hard drive mode. Also copies the
complete description line to SFFILES.BBS.
■ Number of files/bytes downloaded is recorded in the Spitfire
main database and daily download limits are enforced.
(This feature is NOT available in unregistered versions.)
■ Multi-colored file lists just like seen in Spitfire 3.2 & 3.3.
Now supports Spitfire style multi-line descriptions using
the smiley face (ASCII 02) character.
■ Run as a door or menu extension using SFDOORS.DAT, SFFILE.DAT,
SFMESS.DAT or SFMAIN.DAT. Low memory requirements. Only uses
about 180 kilobytes, which includes the memory required for the
DSZ external protocol.
■ Caller time in door is limited to remaining time allowed on BBS.
(This feature is available in ALL versions.)
■ Complete logging of all caller activity.
(This feature is NOT available in unregistered versions.)
■ Download from within door using Xmodem, Ymodem or Zmodem.
A copy of DSZ.COM or DSZ.EXE by Omen Technology Incorporated
is required. Zmodem MobyTurbo is supported.
■ Very rapid text search of both file names and descriptions.
Matches are highlighted in color.
■ File sharing and locking for multinode and network operation. All
file lists, menus, data files and logs may be shared. DOS version
3.0 or higher, with DOS SHARE installed, is required for proper
operation of file sharing and locking. Special collision
avoidance for multi-node and multi-disk. Prevents "thrashing" on
Pioneer multi-disk changer CD-ROM drives.
■ Automatically uses Spitfire's communication port settings.
Comm port speeds to 115,200 bps with hardware or software flow
control. Uses Spitfire's configured port speed, data bits, stop
bit, parity, comm port, I/O port and interrupt. Handles any UART.
Does not require or use a FOSSIL driver, but is compatible with a
FOSSIL if one is installed.
■ Reads DAILYLMT.DAT to determine allowable downloads per day.
■ The door will recognize caller connect speeds of 0, 300, 1200,
2400, 4800, 7200, 9600, 12000, 14400, 16800, 19200.
It will use the value passed by Spitfire in SFDOORS.DAT line 5
to calculate the estimated download times. Note that sometimes
this value is incorrect. Some systems connect at 12000, 14400,
or 16800 but "lie" and tell Spitfire that the connect is 9600.
The good news is that the door now factors in a speed
increase due to error correction.
■ Carrier detection. Resets the BBS if caller drops carrier.
■ Inactivity timeout configurable from 1 to 10 minutes.
■ Multitasker aware. Releases time slices (clock tics) to tasks
running in other windows when SF-Rom is idle.
These multitaskers are automatically detected and supported:
Windows 3.x & NT
DESQview 2.xx
DoubleDOS
VMiX 2.xx
MultiDos Plus 4.xx
OS/2 2.0
DOS 5.0 Task Switcher and Compatibles
TaskView, TopView, OmniView, & Compatibles
■ Runs locally inside of Spitfire (where baud rate = 0).
Local browse and copy to hard drive mode available when
run in Spitfire and also when run local from the command line.
■ Detailed status lines visible on top of local screen.
Shows caller name, statistics, time left, etc.
■ Detailed status screen displayed during download.
Shows caller's entire download/upload history and more.
■ Sysop local keyboard controls same as Spitfire:
ALT+C --- Chat Mode On/Off
ALT+D --- Drop To DOS (local sysop only)
ALT+J --- Drop To DOS (local sysop only)
F6 ------ Take Five Minutes From Caller
F7 ------ Give Five Minutes To Caller
F10 ----- Exit The Door
ALT+F1 -- Exit The Door
ALT+F2 -- Exit The Door
ALT+K --- Kill. Throw the caller off the BBS *NOW*
■ ANSI color or plain ASCII text modes. Initial mode is the same as
passed by Spitfire. Caller can toggle ANSI on/off from within the
door. Door contains its own ANSI driver and can show ANSI
graphics on the local screen even if DOS ANSI.SYS is not loaded.
■ Sysops can design their own (optional) custom screens.
Door will display WELCOME.CLR or WELCOME.BBS before it runs.
(Available in registered versions only).
Place these in the same directory as SFROM.EXE.
If ANSI is on then the .CLR file will be shown, otherwise
the .BBS file will be shown.
■ Several configuration options:
Optional logoff after transfer.
Optional time penalty for dropped carrier.
Configurable number of lines displayed per page.
Can now specify the character used in determining which lines
in a file list contain a valid file for tagging and display
purposes.
Configurable activity log format.
■ DSZmodem is "trapped" inside a window so that data does not
scroll up off screen as download progresses.
------- SETUP for SINGLE-DISK MODE ------------------------------------------
1. Unzip this archive into one subdirectory.
This will be the SF-Rom home directory.
2. Modify the included SFROM.CFG file to meet your needs.
See CONFIGURATION VERBS below for description of each option.
Any line in SFROM.CFG that does not begin with a letter is
ignored. The lines that begin with semicolons, for example, are
used for comments and ignored by the program. Keep this file in
the SF-Rom home directory.
3. Modify the included DISK.CLR and DISK.BBS to meet your needs.
These two files are the list of file areas on the disk and are
mandatory or the program will not run. Try to keep these to
under 21 displayed lines or the top may scroll off the screen.
Additional options for these files are described below.
Keep these files in the SF-Rom home directory.
4. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
path or in the SF-Rom home directory.
5. (OPTIONAL) Place custom screens in the SF-Rom home directory.
Registered versions will display WELCOME.CLR or WELCOME.BBS if
these files exist.
All versions will display GOODBYE.CLR or GOODBYE.BBS after a
download if the caller selects log off after transfer.
6. Run the program using these commands:
CD C:\SF\SFROM
SFROM C:\SF\SFFILE.DAT C:\SF\SFROM\SFROM.CFG
The complete paths and file names must be specified.
Spitfire creates one of the following files when a door
or menu extension is executed. Any one of these may be used
in place of SFFILE.DAT in the above example:
SFFILE.DAT File menu extension
SFMAIN.DAT Main menu extension
SFMESS.DAT Message menu extension
SFDOORS.DAT Door menu
------- SETUP for MULTI-DISK MODE ------------------------------------------
1. Unzip this archive into one subdirectory.
This will be the SF-Rom home directory.
You only need one copy of SFROM.EXE and it must be kept here.
2. Modify the included SFROM.MAS file to meet your needs.
See CONFIGURATION VERBS below for description of each option.
This is the master file that sets the configuration and location
for all of the disks. Any line in SFROM.MAS that does not begin
with a letter is ignored. The lines that begin with semicolons,
for example, are used for comments and ignored by the program.
Keep this file in the SF-Rom home directory.
3. Create a separate subdirectory for each of your CD-ROM disks.
The general arrangement should look something like this:
┌──────────────┐
│ SFROM.EXE │ SF-Rom home directory
│ SFROM.MAS │
│ MAIN.BBS/CLR │
└───────┬──────┘
│
┌─────────────────┼─────────────────┬────── - - - etc.
┌──────┴───────┐ ┌──────┴───────┐ ┌──────┴───────┐
│ SFROM.CFG │ │ SFROM.CFG │ │ SFROM.CFG │
│ DISK.BBS/CLR │ │ DISK.BBS/CLR │ │ DISK.BBS/CLR │
│ FILELISTS │ │ FILELISTS │ │ FILELISTS │
└──────────────┘ └──────────────┘ └──────────────┘
subdirectory subdirectory subdirectory
for disk 1 for disk 2 for disk 3
4. Copy SFROM.CFG to each of the disk subdirectories. This is the
configuration file for that disk and must be modified to suit
that disk. SFROM.CFG must contain the disk name and all the
paths to the files and lists for that disk. This is all that
MUST be included, any of the other settings are optional, but
they will be applied if they are there.
5. Copy DISK.BBS and DISK.CLR to each of the disk subdirectories.
This is the display menu showing the file areas available on the
disk and must be modified to suit the disk. Try to keep these to
under 21 displayed lines or the top may scroll off the screen.
Addition options for these files are described below.
4. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
path or in the SF-Rom home directory.
5. (OPTIONAL) Place custom screens in the SF-Rom home directory.
Registered versions will display WELCOME.CLR or WELCOME.BBS if
these files exist.
All versions will display GOODBYE.CLR or GOODBYE.BBS after a
download if the caller selects log off after transfer.
6. Run the program using these commands:
CD C:\SF\SFROM
SFROM C:\SF\SFFILE.DAT C:\SF\SFROM\SFROM.MAS
SF-Rom runs multi-disk mode if config file extension is .MAS.
(Single-disk mode is selected by using extension .CFG)
The complete paths and file names must be specified.
Spitfire creates one of the following files when a door
or menu extension is executed. Any one of these may be used
in place of SFFILE.DAT in the above example:
SFFILE.DAT File menu extension
SFMAIN.DAT Main menu extension
SFMESS.DAT Message menu extension
SFDOORS.DAT Door menu
------- LOCAL MODE ---------------------------------------------------------
SF-Rom may be run in local mode if you log onto Spitfire
locally. It may also be run in local mode from the DOS
command line:
CD C:\SF\SFROM
SFROM LOCAL
If SFROM.MAS is found in the current directory, then multi-disk
mode is selected. If SFROM.CFG is found, then single-disk mode
is run. Local mode allows you to browse the lists, tag files,
and copy the files (and descriptions) to the hard drive.
------- CONFIGURATION VERBS -------------------------------------------------
Configuration verbs are used in SFROM.CFG for both single-disk
mode and multi-disk mode. The program reads each line and if it
begins with a configuration verb, then the configuration is
modified as directed by the verb. If a line begins with
anything other than a letter, it is ignored. The explanatory
comments are on lines beginning with a semicolon and are
therefore ignored. The verbs are NOT case sensitive, but they
must be spelled correctly. The order of the lines is generally
not important except for the DISKS and AREAS verbs.
For multi-disk mode, many of the same configuration verbs are
also used in SFROM.MAS. The configuration verbs in SFROM.MAS are
read into memory when the program starts. When a disk is
selected by the caller, the SFROM.CFG file for that disk is
read. When returning to the main menu from a disk menu, program
startup values are restored from memory. Most of the
configuration verbs can be set in either (or both) the master
SFROM.MAS or the disk specific SFROM.CFG. The values in the
master prevail when the program is at the first menu. The values
for each disk prevail whenever that disk is loaded or read.
DISKNAME So Much Shareware 2
This verb is only used in SFROM.CFG and has no effect in
SFROM.MAS. This name is used in the local status bar display on
the top of the screen and in the door log entries.
COPYTOMAG ON
COPYTOMAG OFF
Choose one. If CopyToMag ON then files will be copied to the
magnetic hard drive just before downloading. These files will
then be erased once the download is completed. If CopyToMag OFF
then the files will be downloaded directly from the CD-ROM
drive. Default is CopyToMag ON
HOLDDIR C:\SF\CD-HOLD
This is the holding directory where the files are copied to if
CopyToMag is ON. The program also stores the batch download file
list here in all cases. The program takes care of its own
housekeeping and deletes the copied files after the download.
Just the copied files are deleted. Any other files that exist in
this directory will NOT be deleted. In local mode, the files are
also copied here and the descriptions are added to an
SFFILES.BBS in this subdirectory. If no SFFILES.BBS exists, one
is created. The default is the root directory C:\.
LOGNAME C:\SF\CALLERS.TMP
Registered versions only. Gives the name of the caller activity
log file. The default is CALLERS.TMP in the Spitfire home
directory for this node as defined in SFFILE.DAT or equivalent.
LOG ON
LOG OFF
Choose one. Turns call log ON or OFF.
In unregistered versions the log is forced OFF.
In registered versions the default is Log ON.
In local mode the log is forced OFF.
SHARE ON
SHARE OFF
Choose one. Turns file sharing and locking ON or OFF. File
sharing is generally not required on a single-node BBS. This
program will run much faster with Share OFF. The default is
Share ON.
TIMEOUT 180
This is the caller inactivity timeout delay in SECONDS. If no
keystrokes are received for this length of time, the door will
exit and return the caller to the BBS. Values from 60 to 600
seconds are allowed. The default is 180 seconds (3 minutes).
DEBUG ON
DEBUG OFF
Choose one. Most program error conditions are logged to
SFROM.LOG if Debug is turned on. The program may load a bit
faster if you turn this off. If you are experiencing
difficulties, leave Debug ON. The default is Debug ON.
DIRECTVIDEO ON
DIRECTVIDEO OFF
Choose one. With DirectVideo ON, all local screen writes will
done directly to video memory instead of through the BIOS. The
default is DirectVideo ON. This seems to work fine on most
systems.
CHECKSNOW ON
CHECKSNOW OFF
Choose one. CheckSnow ON enables "snow checking" when using
DirectVideo ON. It has no effect if DirectVideo OFF. Some older
CGA monitors may requires this. It should not be a problem on
most monochrome, EGA or VGA video systems. Some systems may run
a bit faster with CheckSnow OFF. The default is CheckSnow ON.
BIOSSCROLL ON
BIOSSCROLL OFF
Choose one. If BiosScroll OFF, then a special scrolling routine
is used that suppresses snow and flicker on systems with any
kind of color graphics. However, BiosScroll ON is a bit faster.
The default is BiosScroll ON.
DROPPENALTY 300
Number of SECONDS to penalize the caller if carrier is dropped
when in the door. This time will be subtracted from the callers
time allowed during the next call that day. If the caller does
not call back until the next day, then this penalty will have no
effect. Values from 0 to 7200 seconds (0 to 120 minutes) are
allowed. The default is 300 seconds (5 minutes).
ALLOWLOGOFF ON
ALLOWLOGOFF OFF
If AllowLogOff ON then the caller will be offered the option to
select unattended automatic logoff after each download. If you
allow logoff then you can place a copy of your desired logoff
display screen(s) in the SF-Rom home directory. This is
optional. If this screen exists, it will be shown only after an
automatic logoff. I use my normal BBS GOODBYE.BBS/CLR.
The default is AllowLogOff ON.
LINESPERPAGE 21
Determines the number of lines shown for each screen page when
the caller is scrolling through the file lists. Values from 5 to
30 lines per page are allowed. The default is 21 lines per page.
TAGCHAR 26 -
This determines the line position and character used to
determine which lines in a file list contain a valid file for
tagging and display purposes. Lines which contain this exact
character at this exact position are colorized and assigned a
tag letter. Lines which do NOT contain this character at this
position are assumed to be header lines or extended description
lines. This option allows the use off many different styles of
file lists.
The default is a dash at position 26 as shown below:
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+
SFROM120.ZIP 75,085 03-07-93 Spitfire CD-ROM Door 1.20 by Mike Robinson
^
character at position (column) 26 is a dash
Examples of common file formats:
TagChar 26 - (tag lines with a dash at position 26) (default)
TagChar 28 - (tag lines with a dash at position 28)
TagChar 26 / (tag lines with a forward slash at position 26)
TagChar 28 / (tag lines with a forward slash at position 28)
TagChar 18 , (tag lines with a comma at position 18 )
Only one character and position may be designated as the
TagChar. If multiple TagChar are specified in SFROM.CFG then the
last TagChar specified is used.
TOTALDOWN ON
TOTALDOWN OFF
Updates the Spitfire global record of how many downloads today.
This is the value seen by callers during logon.
TotalDown is forced off in the unregistered version.
The default is TotalDown Off.
NODOWNLOAD 10 15 20
This sets no download status for listed security levels.
In the example shown above security levels 10, 15 and 20 are not
allowed to download. Up to 20 levels can be set on one
NoDownLoad line. Use as many lines as your require, each line
beginning with NoDownLoad. If running multi-disk and this verb
is set in SFROM.MAS, then it applies to all disks. If set in
SFROM.CFG then it applies to just one disk. The value in
SFROM.CFG prevails.
AREAS
E:\GAMES1 C:\SF\CDROM1\01.LST
E:\GAMES2 C:\SF\CDROM1\02.LST
E:\EDUCATE C:\SF\CDROM1\03.LST
E:\MUSIC C:\SF\CDROM1\04.LST
E:\GRAPHICS C:\SF\CDROM1\05.LST
E:\CLIPART C:\SF\CDROM1\06.LST
E:\GIFS C:\SF\CDROM1\07.LST
E:\HOBBY C:\SF\CDROM1\08.LST
AREAS
The AREAS configuration verb is a special case. It is only used
in SFROM.CFG, but it is used for both single-disk mode and
multi-disk mode. It is used to signify both the beginning and
end of a list of file areas. The example above shows 6 file
areas, but you can have as many as 1000 file areas per disk.
There must be one area per line and they must be on consecutive
lines. The first line is file area number 1 and the rest follow
in order until you reach the end.
The list MUST BEGIN and END with the keyword "AREAS".
The list MUST BEGIN and END with the keyword "AREAS".
Each line has two entries separated by at least one blank space.
The first is the path to the file area on the CD-ROM. The second
is the full path and filename of the associated file list. The
list can have any filename, it does not have to be SFFILES.BBS.
The file lists can be located on a normal magnetic hard disk or
on the CD-ROM (if they exist on the CD-ROM). The door will run
much faster if you locate the file lists on the normal magnetic
hard disk. Note that you can also use this door to access normal
file areas on your hard drive. You can mix normal file areas
with CD-ROM areas in the same door. The file areas do not have
to reside on the same drive letter or same physical drive. If
you have a network, you can access file areas on a different
machine. You could even put ALL of your Spitfire file areas in
one or more of these doors. For example, you could put adult
files in one door and restrict access to adults only. Or you
could have special file doors reserved for privileged,
contributing or subscribing callers.
The example above is a portion of the sample SFROM.CFG supplied
in this package. It is for the "So Much Shareware 2" CD-ROM disk
first published in September 1992. The file lists are resident
on the CD-ROM as SFFILES.BBS in each subdirectory and can be
easily copied to a hard drive.
DISKS
1 ON >5 0 C:\SF\CDROM1\SFROM.CFG
2 ON <30 0 C:\SF\CDROM2\SFROM.CFG
3 ON =20 0 C:\SF\CDROM3\SFROM.CFG
4 OFF >5 0 C:\SF\CDROM4\SFROM.CFG
5 ON >5 20
6 ON >5 0 C:\SF\CDROM6\SFROM.CFG
DISKS
The DISKS configuration verb is a special case. It is only used
in SFROM.MAS and is for multi-disk mode only. It is used to
signify both the beginning and end of a list of disks. The
example above shows 6 disks, but you can have as many as 100.
There must be one disk per line and they must be on consecutive
lines.
The list MUST BEGIN and END with the keyword "DISKS".
The list MUST BEGIN and END with the keyword "DISKS".
COLUMN 1 is the key character that the caller uses to select the
disk. Number 1 to 6 are shown, but any almost any single
character may be used. This includes letters, numbers and
symbols. Letters must be uppercase. Do not use the letters K,
Q, and S since these are used to select options on the SF-Rom
main menu. Do not use numbers greater than 9 since these
require more than one character.
COLUMN 2 shows if door is ON or OFF line. If OFF, the disk is
browse-only with no downloads allowed.
COLUMN 3 shows the security level required to enter the disk.
For example if it is set to:
>5 (only security levels greater than 5 may enter)
<30 (only security levels less than 30 may enter)
=20 (only security level equal to 20 may enter)
There must be no spaces between the symbol and the level
number.
COLUMN 4 is the type. Set this to 0 for a CD-ROM disk. Set it
any value between 10 and 255 and SF-Rom will terminate with
this ErrorLevel when this door is selected by the caller. This
allows SF-Rom to be used like an external menu program. In
this case, you need to catch and respond to these ErrorLevels
in the batch file that runs SF-Rom. CD-ROM disks and external
doors may be combined freely in the same menu. A normal SF-Rom
exit where no door or disk is selected is ErrorLevel 0.
Internal errors in SF-Rom exit with ErrorLevel 1. Do not set
ErrorLevels 1 to 9 as these are reserved for future use.
COLUMN 5 is the full path and file name of the SFROM.CFG used
for each CD-Rom disk. Create a separate subdirectory for each
disk. Place all the files for that particular disk in the same
subdirectory along with the SFROM.CFG for that disk. Column 5
is blank if this line indicates an external door.
STYLE 1
STYLE 2
STYLE 3
Choose one of the style commands shown above. Determines the
style of the download line in the caller activity log entries in
registered versions only. Has no effect in unregistered
versions. Some third party utility programs read the callers log
and count or log downloads. These programs require certain
download log entry styles which are similar to those created by
a normal Spitfire download.
Three styles are now offered. More will be added if requested.
Only one style may be used in each configuration file. If
multiple styles are specified, then the last one specified is
used.
For Style 1 a typical log entry looks like this:
1800LIST.TXT 2,276 Listing Of 1-800 BBS Systems
This is the default style and is the same as all previous
versions of SF-Rom.
For Style 2 a typical log entry looks like this:
Downloaded E:\MODEM\800LIST.TXT
Note that this is the path to the file on the CD-ROM.
For Style 3 a typical log entry looks like this:
Downloaded C:\SF\CDROM1\800LIST.TXT
Note that this is the file name appended to the path
to the file list that contains the file.
BUSYFLAG C:\SF\CD-HOLD\DRIVE1.BSY
For use in multi-disk mode. Optional. A semaphore marker file
system of collision protection is set by this verb. SF-Rom
checks for the existence of this busy flag file before each
CD-ROM read. If the file is there, then it waits until the other
node erases the file. SF-Rom creates this file whenever it
begins to read from the CD-ROM drive and erases this file when
the read is complete. The same busy flag name must be set for
each disk that uses the same drive.
FLAGDELAY 30
For use in multi-disk mode. Optional. Sets the maximum time
in seconds that the door will wait for a busy CD-ROM drive.
The default is 30 seconds which means the door will wait for
up to 30 seconds before halting the attempted disk read
operation and sending a message of "please try again later."
The allowable range is 0 to 300 seconds.
DELOLDFLAG 30
For use in multi-disk mode. Optional. When SF-Rom encounters a
busyflag, it checks it's age. If it is older than DELOLDFLAG in
minutes, then the flag is deleted. Only the flag declared by the
BusyFlag verb in the same configuration file is deleted. This is
a cleanup feature in case old flags are orphaned by a power
failure or other system problem. The default is 30 minutes which
means the door will delete any flag older than 30 minutes. The
system clocks on a network must be synchronized in order for
this verb to work properly. It is recommended that you set this
value to at least the maximum system time difference between any
2 network nodes. Remember that PC system clocks will drift out
of synchronization over time.
The allowable range is 5 to 720 minutes.
CHECKSIZE ON
CHECKSIZE OFF
Choose one. For use in either multi-disk or single-disk mode.
Optional. The default is CheckSize ON.
If ON, then the CD-ROM drive will be read during file tagging
to determine if the file is actually there and it's size/date.
This is the same as in all previous versions.
If OFF, then the CD-ROM will not be read during file tagging.
The file size and date will be read from the file list.
This will speed up the tagging operation and reduce the load
on the CD-ROM drive on multi-node and networked systems.
OFF should work well if your file lists are in Spitfire format
and are accurate. Note that if the file size in the list is
wrong, a caller could exceed his daily byte or time limit.
If set OFF and a file size cannot be read from the list, then
a default size of 50 kilobytes is used. If this verb is used in
SFROM.MAS, then it applies to all disks. If used in SFROM.CFG,
it applies to just one disk.
SOFTFLOW
Do not use this verb unless you are sure you need it. Flow
control is ALWAYS hardware (RTS/CTS) unless this verb is used.
It FORCES software flow control (XON/XOFF) and shuts off
hardware flow control. The Software Data Flow Control value
passed by Spitfire on line 19 in SFFILE.DAT is no longer used.
Hardware flow control is better and most modern modems support
it. Even if you are running Spitfire with hardware flow control
off, you should probably not use this verb. SF-Rom can usually
run with hardware flow control even if Spitfire is not using it.
------- DISPLAY FILES -------------------------------------------------------
In multi-disk mode, the following display files may be used
to show the list of available disks:
ANSI ASCII
----------- -----------
MAINxxx.CLR MAINxxx.BBS
MAINxxx.BBS MAIN.BBS
MAIN.CLR
MAIN.BBS
The "xxx" shown above represents a security level. For example,
MAIN10.CLR is the ANSI menu for security level 10. SF-Rom
searches for the display files in the order indicated above.
If specific display files are not found for the caller's
security level, then the general MAIN.CLR/BBS files are shown.
In both single-disk mode and multi-disk mode, the following
display files may be used to show the list of available
file areas on a specific disk:
ANSI ASCII
----------- -----------
DISKxxx.CLR DISKxxx.BBS
DISKxxx.BBS DISK.BBS
DISK.CLR AREALIST.BBS
DISK.BBS
AREALIST.CLR
AREALIST.BBS
The "xxx" shown above represents a security level. For example,
DISK150.BBS is the ASCII menu for security level 150. SF-Rom
searches for the display files in the order indicated above.
If specific display files are not found for the caller's
security level, then the general DISK.CLR/BBS files are shown.
The AREALIST.CLR/BBS files are included as a last choice for
compatibility with previous SF-Rom versions.
- MULTI-PAGE MENUS -
You can also create a multi-page MAIN.CLR/BBS and/or
DISK.CLR/BBS. In this case, put all the pages in one file. Each
page should be no more than 21 displayed lines long and there
should be 4 blank lines between each page. The door will pause
at the end of each page and allow the caller to select a command
or scroll to the next page.
------- REGISTRATION --------------------------------------------------------
This is SHAREWARE. You may use this program for a free 30 day trial
period. After that, you must register it or stop using it.
You may give away free copies of this entire unmodified package,
but you may not sell it. I retain all rights to this program.
As an incentive to encourage registration, the following features
are ONLY AVAILABLE IN THE REGISTERED VERSION:
■ The *** UNREGISTERED *** message on the first screen is replaced
by your name and your BBS Name.
■ Spitfire's daily download file and byte limits will be enforced
by the door. The door will also record all downloads and add the
number of files and bytes downloaded to the main Spitfire data
base. So the caller's total daily downloads (sum of downloads
inside the door and normal Spitfire downloads) will never be more
than allowed by Spitfire in DAILYLMT.DAT. These limits are
correctly tracked in any combination, even if the caller enters
and exits the door several times. If Spitfire says a caller can
only grab 10 files per day, he will only be able to grab 10 files
total per day.
example:
A caller is allowed 10 downloads per day. He downloads 3 files
in this door. He is then only allowed 7 more downloads when he
returns to Spitfire.
In the unregistered version, only the caller's daily time limit
is enforced. In the unregistered version, downloads are not
recorded and file/byte per day limits are not enforced.
■ WELCOME.CLR or WELCOME.BBS file will be displayed (optional).
■ Full logging of all caller activities in the door to CALLERS.LOG
or any file you choose. These log entries are designed to blend
nicely with the normal Spitfire log entries.
Here is an example from the CALLERS.LOG on my BBS:
-----------------------------------------------------------------
John Smith called at 14:34:37 on 03-07-93 using Node 1 at 2400 baud.
Entered So Much Shareware at 14:35:51
1800LIST.TXT 2,276 Listing Of 1-800 BBS Systems
GOVTBBS.ZIP 3,781 List Of Gov't BBS Numbers
WHATPORT.ZIP 9,044 Handy To Find Conflicting COM Ports
Begin Zmodem at 14:39:20 Estimated Time: 1.1 Min.
End Zmodem at 14:40:26 Actual Time: 1.1 Min.
Updated download records +3 file(s) and +15,101 bytes.
Exited So Much Shareware SF-ROM Door at 14:41:05
John Smith logged off at 14:43:02
-----------------------------------------------------------------
In the unregistered version, only error conditions are logged.
No caller activity log is created in the unregistered version.
Registration is $20 (Twenty) dollars in US funds.
Personal check, bank check or money orders are acceptable.
Registered Sysops are entitled to free program support, free
upgrades to all future versions, and free access to all files and
features on my BBS. Support is available from me on my BBS, in
CircuitNet and in FidoNet. Suggestions for future improvements from
registered Sysops will receive careful consideration.
In order to register the program, you will have to call my BBS and
download your personal registration key and instruction file. This
key will work for all future versions, so there will be no need to
download any specially compiled versions of the executable program
itself.
If you do not yet have access to my BBS, please be sure to send
along a password and birthdate with your registration. Then I can
set up your logon account in advance. Please be sure to specify
your name and your BBS name exactly as you would like them to
appear on the first door screen.
Your personal registration key and instruction file will be
ready for you to download on the day I receive your check,
usually by 19:00 eastern time.
Registrations will not be mailed.
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
SF-Rom 1.20 Door REGISTRATION FORM
Your Name:
(40 characters maximum)
BBS Name:
(40 characters maximum)
BBS Phone Number:
(xxx-xxx-xxxx)
Password to use on Mike Robinson's BBS:
(14 characters maximum)
BirthDate to use on Mike Robinson's BBS:
(mm-dd-yy)
Your Address:
Send this form and $20 (Twenty) dollars in US funds to:
Michael Robinson
9 Richard Boulevard
Shelton, CT. 06484
Personal check, bank check or money orders are acceptable.
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
╔═══════════════════╗ ╔══════════════════════╗ ╔═══════════════════╗
║ The Soft Parade ║ ║ Sysop: Mike Robinson ║ ║ 1200 to 16800 bps ║
║ Shelton, CT. USA ║ ║ Spitfire version 3.3 ║ ║ HST V.32bis ║
║ 203-924-5603 ║ ║ Open 24 hours 7 days ║ ║ MNP 5 V.42bis ║
║ FidoNet 1:141/485 ║ ║ CircuitNet 203004 ║ ║ USR Dual Standard ║
╚═══════════════════╝ ╚══════════════════════╝ ╚═══════════════════╝
Latest version of the SF-Rom Door may be File Requested (freq'ed)
by any Fido compatible mailer 24 hours a day using the
magic name: SFROM
24 hour crash mail & file requests of any file listed in FILES
Magic Names: FILES SPITFIRE NODEDIFF SFTS BINKLEY
ABOUT BBSLIST NODELIST DOGFIGHT BNU
SFROM PMEISTER CATCHEM
Legal Stuff:
Use this program at your own risk. No guarantees of any sort.
"SPITFIRE" is Copyright (C) 1987-1993 by Mike Woltz.
"SPITFIRE" is a registered trademark of Buffalo Creek Software.
File sharing and locking implemented via BCSHARE Beta Version 0.7
Copyright (C) By Mike Woltz 1990 Buffalo Creek Software.
DSZ program Copyright by Omen Technology Inc.
SF ROM Revision History (abbreviated)
Version 1.00 -- May 31, 1992 - Initial Public Release
Version 1.10 -- Sep 05, 1992 - Added batch downloads & file tagging.
Version 1.15 -- Oct 10, 1992 - Various bug fixes and test versions.
Version 1.20 -- Mar 7, 1993 - Multiple disk support. Enhancements.